.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH "MKDNSMAP4ME" "1" "fevereiro  8, 2006"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
mkdnsmap4me \- program to create DNS map files in a fast way
.SH SYNOPSIS
.B mkdnsmap4me
.RI " <IP preffix> <domain_name> <servers_names file> <first server IP suffix> <number of enabled servers> [ <clients names file> <first client IP suffix> <number of enabled clients> [ <printers names file> <first printer IP suffix> <number of enabled printers> ] ]"
.br
.SH DESCRIPTION
This manual page documents briefly the
.B mkdnsmap4me
system administrator tool.

Usually, system admnistrators need to create DNS maps to configure new DNS servers. It's very common solution create these maps using name themes like movies, books, natural resources, cities, states and countries. However, it takes system administrators a long time even if they take templates from other network environments.

.B mkdnsmap4me 
is a script to save the system administrators time helping them to create DNS maps in a fast way. Using name themes, this tool is able to take informations like domain name, IP preffix, IP range for servers and clients and the number of each one host type to generate direct and reverse DNS maps for a domain. System administrators can use the themes included in the package or create your own themes just including names for hosts in ascii files.


.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.
.\" \fBmkdnsmap4me\fP is a program that...

.SH OPTIONS
The \fBmkdnsmap4me\fP has a fixed number of arguments to generate DNS zone maps.

These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
For a complete description, see the Info files.
.TP
.B <IP preffix>
The three firts octets from the IP address to use. Example: "192.168.10" and "10.1.2".
.TP
.B <domain name>
This domain name will be used to generate the DNS maps. Example: "comunidadesol.org".
.TP
.B <servers names file>
An ascii text file including hosts names to use for the servers. You must have one hostname for each line or you can separate them using spaces. Blank lines and lines beginning with "#" are considered as comments.
.TP
.B <first server IP suffix>
This suffix will be use to create the first IP address in the server category joining it with the IP preffix. For example, if your IP preffix is "192.168.10" and your first server IP suffix is "5", the first name in the servers names file will be associated with the "192.168.10.5" IP address.
.TP
.B <number of servers>
This argument describes the number of servers to be enabled in the direct and reverse DNS maps. This number cannot be less than the number of the hosts names included in the <servers names file>. If it happen, mkdnsmap4me will be aborting its execution. If there is more host names in the <servers names file> than the <number of servers>, mkdnsmap4me will be comment them in the maps. To use them in the future, you will need just uncomment the desired hosts names in the DNS map files and restart BIND daemon.
.TP
.B <clients names file>
An ascii text file including hosts names to use for the clients. You must have one hostname for each line or you can separate them using spaces. Blank lines and lines beginning with "#" are considered as comments.
.TP
.B <first client IP suffix>
This suffix will be use to create the first IP address in the client category joining it with the IP preffix. For example, if your IP preffix is "192.168.10" and your first server IP suffix is "20", the first name in the servers names file will be associated with the "192.168.10.20" IP address.
.TP
.B <number of clients>
This argument describes the number of clients to be enabled in the direct and reverse DNS maps. This number cannot be less than the number of the hosts names included in the <clients names file>. If it happen, mkdnsmap4me will be aborting its execution. If there is more host names in the <clients names file> than the <number of clients> specified, mkdnsmap4me will be comment them in the maps. To use those names in the future, you will need just uncomment the desired hosts names in the DNS map files and restart BIND daemon.
.B <printers names file>
An ascii text file including hosts names to use for the printers. You must have one hostname for each line or you can separate them using spaces. Blank lines and lines beginning with "#" are considered as comments.
.TP
.B <first printer IP suffix>
This suffix will be use to create the first IP address in the printer category joining it with the IP preffix. For example, if your IP preffix is "192.168.10" and your first server IP suffix is "100", the first name in the servers names file will be associated with the "192.168.10.100" IP address.
.TP
.B <number of printers>
This argument describes the number of printers to be enabled in the direct and reverse DNS maps. This number cannot be less than the number of the hosts names included in the <printers names file>. If it happen, mkdnsmap4me will be aborting its execution. If there is more host names in the <printers names file> than the <number of printers> specified, mkdnsmap4me will be comment them in the maps. To use those names in the future, you will need just uncomment the desired hosts names in the DNS map files and restart BIND daemon.

.SH EXAMPLES
.TP
.B mkdnsmap4me 192.168.1 comunidadesol.org rivers.txt 3 5 birds.txt 50 40
In this example, mkdnsmap4me will create the direct and reverse DNS maps to "comunidadesol.org" domain name. The IP address preffix to use is 192.168.1. mkdnsmap4me will take names for servers from rivers.txt file. The first server IP address will be 192.168.1.3 and the last will be 192.168.1.7. If rivers.txt has more than five names, mkdnsmap4me will comment them to use in the future following the IP suffix. For example, if there are 10 names in the rivers.txt file, IP address from 192.168.1.8 up to 192.168.1.12 will be created with comments in the both DNS maps.  To clients, mkdnsmap4me will take names from birds.txt file. The IP range form clients will be from 192.168.1.50 up to 192.168.1.89 like in the servers. If one of those files, rivers.txt or birds.txt, have less host names than required for the user, mkdnsmap4me abort its execution printing a error message. 
.TP
.B mkdnsmap4me 10.30.5 linux.org starwars.txt 5 10 lordoftherings.txt 10 20
In this case, mkdnsmap4me will be abort its execution because it will find a conflict in the servers and clients IP ranges. The first type, servers, has a IP range from 10.30.5.5 up to 10.30.5.14. The second type, clients, has a IP range from 10.30.5.10 up to 10.30.5.29. mkdnsmap4me will be considering the names reserved to the future to analyse the IP range conflicts. In this case, a different message will be printed on screen before mkdnsmap4me abort its execution.

.SH SEE ALSO
.BR bash (1),
.BR named (8),
\fIBIND 9 Administrator Reference Manual\fR.

.SH AUTHOR
mkdnsmap4me was written by Jansen Sena <jansen@comunidadesol.org>.
.PP
This manual page was written by Jansen Sena <jansen@comunidadesol.org>.
